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Features 


Process Management 


Real-Time 
Multi-Tasking 
Single or Multi-User 
Protection 
Protected File Access 
Protected Memory 


Async I/O System 


31 Events per process 

Wait for multiple events 

Software Interrupts on event completion 
Dynamically Loadable Device Drivers 
Modular 


Console System 


Virtual Consoles 
16-bit/8-bit Character Sets 
Standard Terminal I/F 
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Standard VDI Interface 

shared File System 

Hierarchical Directories 

DOS 3.x Compatible 

File ownership 

IBM PC Networking Compatible (SMB) 
Transparent Access 


CPU and Device Independent Interface 
Front Ends 

PC DOS 2.1 

CPM-68K 

International Character Sets 

Customizable Messages 
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The File System 
(Supervisor) 


Controls Access to all Resources 
Driver Installation and Removal 

All Files and Devices are Named 
Logical Name Substitution 
Concurrent File Access Protection 
Protected Access by User/Group ID 


Unique Table for each File Type 
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File Naming 


[node::|device:[\|[directory\]...[filename] 


node:: network node name 
device: logical device name 
\ root directory 


directory\ subdirectory name 
filename file name (and extension) | 


1 
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Logical Names 


@® DEFINE SVC 

@ Prefix Substitution 

@® Literal option 

@ Up to 99 levels of definition 

@ default: applied to filenames without node and device names 
@ system: applied if default fails, must have SYSTEM attribute 


Examples: 
home: hdO:\mydir\ 
con: con2:\vc003\ 
con con:console 
prn: pri2: 
stdin con 
stdout prn: 
stderr con 
path default: home: system: 


prompt $t$g 
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Kinds of Files 


DISK 
DISKFILE 
PCONSOLE 
VCONSOLE 
CONSOLE 


Disk Device Control, RAW I/O 
Disk File I/O, Control 

Physical Console Control 
Virtual Console Control 


Keyboard and Screen I/O 


LEFT, RIGHT, BOTTOM, TOP Window Border I/O 


PIPE 

SERIAL 

PRINTER 

PORT 

SPECIAL DEVICES 
NETWORK DEVICES 
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Pipe I/O 

Serial Device I/O and Control 
Printer Device I/O and Control 
Port Sub-Driver Control 
Special Device I/O and Control 


Network Device Control 


} 


File Security 


User LOGON determines User/Group ID 


Each file is created with a SECURITY WORD: 


Each OPEN attempt is validated by comparing the OPEN Access Request 


with the SECURITY WORD and Previous Successful Opens 


OPEN Access Requests: 
Read Shared/Exclusive 
Write Shared/Unique File Pointer 
Execute Reduced Access 


Delete (Set) 
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File I/O 


OPEN, CREATE returns File Number 


READ, WRITE, SPECIAL, CLOSE, GET 
and SET operates with File Number 


I/O Control Block is Independent 
of type of file 


Byte Level I/O 
I/O Relative from: 
Beginning of File 
End of Fille 
File Pointer 
Shared or Unique File Pointer 


Record Locking 


STDIN, STDERR, STDOUT 
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SVC Interface 


__osif(function,parameter); 


function = SVC function # 
parameter = 32 bit number or 
Parameter Block Address 


286 Assembler: 
CX = function 
BX:AX = parameter 
INT 220 


68K Assembler: 
DO.W = function 
D1.L = parameter 
TRAP 14 
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SVC Parameter Block Format 


ID - Parm1 


Buffer Address - Parm2 


Buffer Length - Parm3 
° ram 
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File Management SVC’s 


DEFINE 


CREATE 


DELETE 


OPEN 


CLOSE 


READ 


WRITE 


SEEK 


LOCK 


RENAME 


COPY 


ALTER 


Define Logical Name 
Create a File 

Delete a File 

Open a File 

Close a File 

Read a File 

Write a File 

Modify/Obtain File Pointer 
Lock/Unlock Area of Disk File 
Rename or Move a File 
Copy Screen Rectangle 


Alter Screen Rectangle 
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Device Management SVC’s 
SPECIAL Perform Special Device Function 
DEVLOCK Lock/Unlock Device 

INSTALL — Install/Replace/Link Drivers 
Event Management SVC’s 
CANCEL Cancel Events 

WAIT Wait for Events 

STATUS Get Event Status 


RETURN Get Event Completion Code 
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Process Events (Event Bits): 


Created only in Process Context 

Up to 31 Outstanding Events per Process 

Each event represented by an Event Bit 

WAIT - Wait for Multiple Events 

RETURN - Obtain Return Code of Single Asynchronous Event 

STATUS - Obtain Completion Status of outstanding Events (event mask) 
CANCEL - cancel events (Event Mask) 
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Process Management SVC’s 


TIMER 


ABORT 


COMMAND 


EXCEPTION 


MALLOC 


MFREE 


EXIT 


ENABLE 


DISABLE 


SWIRET 


CONTROL 


OVERLAY 


Create Timer Event 
Abort Specified Process 
Perform Program Load 
Set Exception Trap 
Allocate Memory 

Free Memory 

Terminate with Error Code 
Enable SWI’s 

Disable SWI's 

Return from SWI 
Control a Process 


Load Overlay 
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Console Management SVC’s 


KCTRL Obtain keyboard 
ORDER Order Windows 
XLAT Keyboard Translation 


GIVE Give Keyboard to Child 
Table Management SVC’s 


GET Get Table Info 
SET Set Table Info 


LOOKUP Wildcard Lookup of Tables 
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DISK 
DISKFILE 
PCONSOLE 
VCONSOLE 
CONSOLE 
PRINTER 
PORT 
SPECIAL 


FlexOS 


Pipe File Information 

Disk Device Information 
Disk file Information 
Console Device Information 
Virtual Console Information 
Console File Information 
Printer Device Information 
Port Device Information 


Special Device Information 


Supervisor Tables 


PROCESS 
ENVIRON 
TIMEDATE 
MEMORY 
SYSTEM 
FILNUM 
SYSDEF 
PROCDEF 
CMDENV 
DEVICE 
PATHNAME 


Process Information 

Process Environment Information 
System Time and Date 

System Memory Information 
Global System Information 

Open File Information 

System level defined names 
Process level defined names 
Command Environment 

Global Device Information 


Expanded Path given logical name 
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Resource Managers 


Static Drivers (minimum driver set) 
OS data pools 

Maximum Memory 

CONFIG Process Startup (Dynamic Memory Sizing etc. 


Initialization 


BOOT:CONFIG BAT - Boot Ont 


Logon Protection Option 
Loadable Drivers 
Default Logical Names 


"Normal Shell Script" 


SYSTEM-USER TAB - LOGON Opti 


PION 


User Names 

Default Window Manager and Shell 
Home Directory 

User/Group ID, Password 
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“The Flexible Automation Operating Systeen 
Device Drivers 

Static or Dynamic 

Dynamic Drivers can be Installed or Removed at any time 

Supports One or More Units 

Each Unit is a logical device 

Driver Units optionally synchronized at Driver or Unit level 

Driver Units are controlled by Resource Managers or 


by other Driver Units (becoming a Sub-Driver) 
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Example of Drivers and Sub-Drivers 


| BMAP.DVR 
CONSOLE con1: (0) 


Resource 


Manager 


VT52.DVR 

| con2: (0) 
LF cond: (0 
a —— portt: (0) (0) 
isc | — porta: (1) | 
acces (unused units) 


p 
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Disk Re 


irce Manager 


PC DOS 3.x Media Compatible 
Hierarchical Directories 
Asynchronous Record Locking 
File Ownership by User/Group ID 
Directory Label 

Fixed Length Records 


Mixed Case Media 
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ole Re rce Manaqger 


On 


Multiple Physical Consoles 
Virtual Console Management 
Tree Structured 
Dynamically created and deleted 
Windows - Control Size, Placement, 
and View of Virtual Consoles Characters 


Standard Keyboard -CTANGLE 
VT52 plus Extensions . USER Frame 
Optionally Modified by Driver OEM Extension 
Standard Screen COPY/ALTER Screen Model 
8 or 16-bit Modes for Input and/or Output 
Supported Character Sets: VFRAME - Driver Representation of 
US - 8-bit IBM PC Virtual Console 
Europe - 8-bit ISO ASCII PFRAME - Physical Representation 
Japan - 8-bit KANA 
Shift-JIS KANJI 
16-bit KANJI 
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Pipe Resource Manager 


"pi:" device, named pipes 

Interprocess Communications (Message Pipes) 
Interprocess Synchronization (Semophore Pipes) 
In memory buffers Only 

Dynamically Created and Deleted 

Security 

Non-Destructive Reads 

Temporary Pipe (Delete on Last Close) 

Provision for "server" processes to WAIT 


instead of EOF on CLOSE of opposite end 
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Network Resource Manager 


Loadable Resource Manager and Drivers 

Based on OSI/ISO Mode! 

PC/NET 1.0 Compatible 

Default and Extended security (LOGON) 

Transparent Access to Remote Resources 
OEM Transporter - Easy for an OEM to Port to their Hardware 


Logical Node and Socket Naming 
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Graphics 


Industry Standard VDI (Virtual Device Interface) 
Compatible with GEM VDI 
Device Types : 
Console 
Printer 
Plotter 
Camera 
Mouse 
Metafiles 
Virtual Consoles 
Windows / Borders 
VDI drivers can be modified by OEM 
to support diverse hardware 
Example implementations include: 
IBM PC/AT CGA 
IBM PC/AT EGA (10 colors) 
Hercules Mono Card 
EPSON High / Low Res Graphics Printer 
‘Mouse Systems Mouse 
Summamouse Mouse 
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VDI Functionality 


GSX SVC 
Color or Mono 
Normalized Device Coordinates 
Device Independent Operations 
Automatic Transformation of NDC to RC 
Raster Coordinates 
High Performance 
Alpha and Graphic Modes 
Vextor Operations 
Line 
Circle 
Elipse 
Pies 
Rectangles 
Arc 
Pattern Fill 
Raster Operations 
BIT-BLT 
Multiple Character Fonts 
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FlexOS 


System Memory Space 


OS code and data 
Driver Code and Data 
SALLOC’d memory 


(running user code) 


CODE 


DATA 


STACK 


HEAP 
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Loaded 

Non-modifiable 

Sharable currently mapped 
Loaded user space _ 


Non-executable 


Created at Load (running system code) 
Non-executable 

Dynamic 

Non-executable 


OS Memory Model 


The Flexible Automation Operating System 


Mapped and Protected MMU's | 


Dynamic First Fit Allocation 
of TPA and logical Address Spaces 


User Space, System Space and 
Physical Memory are Independent 
Address Spaces 


Driver Services provide: 
Address Space Conversion 
User Space Remapping 
User Space Locking 


Addressability to Physical 
Memory that is notin TPA 
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Interr arvice Routines (ISR 
Global Interrupt Stack (4K) 
SETVEC initializes Interrupt Vectors 
Nested ISR’s Allowed 


DOASR - Only OS Service allowed 
Machine State automatically Saved/Restored 


- 


ISR can be written in ’C’ 
“Force Dispatch" Option 
Philosophy: Keep ISR short, use ASR for Extra Work 


Tick ISR Be lr creummomonns CS 

DOASR (Tickit) 
eer 

Tickit ASR == 
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Dispatcher 
Interrupt Handler 
MWAIT ——____» 
OKDISP 
DSPTCH 


Save Process Context 
Switch to Dispatcher 
Schedule Process if Runnable 


Run All ASR’s 


(processes may be scheduled) 


Poll Hardware (POLLEVENT) 
<——- (any more ASR’s? ) 


“@—— (any Processes to run? } 
Return <———__—__. Switch to Highest Priority Process 
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Asvnchron rvice Routines (ASR) 


Second Level Interrupt System 


Runs under Dispatcher Context 


Prioritized Scheduling, FIFO if equal 


ASR’s always runs to completion (except ISR’s) 
scheduled from ISR, ASR or process 
- All scheduled ASR’s run before processes 


ASR’s can be scheduled to run upon Event Completion 


ASR’s cannot WAIT 


| fexi03.gem 


The Flexible Automation Operating System 


[| DIGITAL RESEARCH — FlexOS 


ASR Events (Event Numbers): 


Created in ASR context 

Unlimited # ASR Events 

NEXTASR - Schedule ASR on Event Completion 

RETURN - Obtain Completion Status (Event must be complete) 
STATUS - Obtain Status of single Event 


Cancel - Cancel single ASR Event 


EVASR - Convert Process Event to ASR Event and Schedule ASR 
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Kernel Timings 


Measured on IBM PC/AT at Estimated time at 
6 MHz with 1 memory 8 MHz with 0 wait states 


wait state (.6 x measured time) 

Process Dispatch (Different Process) .309 msec .185 msec 
Process Dispatch (Same Process) 247 .148 

Tick Overhead .474 + Tick ISR .284 + Tick ISR 
ISR Handler Overhead (no dispatch) .080 048 

DOASR .070 042 

Interrupt to ISR .060 .036 

ISR to ASR .163 .098 

Last ASR to Process (Diff. Process) .200 .120 

Last ASR to Process (Same Process) 138 .083 
FLAGEVENT 359 215 

FLAGSET 242 | .145 
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Driver Header 


Driver Header Contains: 


Maximum Number of Units Allowed 
Synchronization Level Needed 
INIT Address 

Data SUBDRIVE Address 

UNINIT Address 

SELECT Address 

FLUSH Address 

READ Address 

WRITE Address 

GET Address 

SET Address 

SPECIAL Address 

Pointers to System Variables 


Driver Header 
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Asynchronous Driver I/O 


Resource Synchronous Asynchronous 
Application Manager Driver Driver Hardware 
Portion Portion 


site | | perform 
| operation 


FLAGEVENT 
| (return event mask) | 


do other things ae 


WAIT 


sleep until 


(event complete) 
| event complete | 


(retcode stored by kernel 


until RETURN SVC) 
RETURN 


return code 


Application Salita Driver Portion 


gore 


. Cl DIGITAL RESEARCH FliexOS The Flexible Automation Operating System 


FLAGCLR Clear a System Flag 
FLAGEVENT Get Flag Event 
FLAGGET Allocate System Flag 
FLAGREL Free System Flag 
FLAGSET Satisfy a Flag Event 


Device Poll 
POLLEVENT Get Hardware Pool Event 
Memory Management 
MAPU Map User Memory 
MAPPHYS = Map Physical Memory 
MLOCK Lock User Memory 


MRANGE Check Buffer Range 
MUNLOCK — Unlock User Memory 


PADDR Convert System to Physical 
SADDR Convert User to System 
SALLOC Allocate System Memory 
SFREE Free System Memory 
UADDR Convert System to User 


UNMAPU Re-map User Memory 
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ASR Management 
ASRWAIT Wait for ASR Event 
DOASR Schedule an ASR 
DSPTCH Force a Dispatch 
EVASR schedule ASR on Proc. Event 
NEXTASR Schedule ASR on ASR Event 
Critical Rea} 
ASRMX Obtain MX Region 
MXEVENT Obtain MX Region 
MXINIT Create MX Region 
MXREL Release MX Region 


MXUNINIT Delete MX Region 
NOABORT — Enter No Abort Region 
NODISP Enter No Dispatch Region 
OKABORT _ Exit No Abort Region 
OKDISP Exit No Dispatch Region 


Other 
PCREATE Create Process 
SETVEC Initialize Interrupt Vector 
SUPIF Make Supervisor Call 
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ASSIGN 
BACK 
BACKUP 
BANNER 
CANCEL 
CAT 
CHDIR 
CHKDSK 
COMMAND 
COMP 
CONFIG 
COPY 
CITY 
CUT 
DATE 
DEFINE 
DIFF 

DIR 
DISKCOMP 
DISKCOPY 
DISKSET 
DUMP 
DUP 
ECHO 
ERASE 
EXIT 
FDISK 
FGREP 
FIND 
FORMAT 
FSET 
GREP 
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Utilities and Built-in Commands 


Assign Logical Drive Name 
Start Background Command 
File Backup 

Print Banner 

Terminate Process 

Copy STDIN to STDOUT 
Change Default Directory 
Check Disk Integrity 

User Shell 

Compare files 

Configure Serial Port 

Copy Files 

Change STDIN and STDOUT 
Cut Fields from File 
Display/Set Date 

Define Logical Name 
Display File Differences 
Directory 

Compare Disk Devices 
Copy Disk Image 

Set Disk Device Information 
Display File Contents 

Print String Multiple Times w/Variables 
Echo command Tail 

Erase Disk File 

Exit Shell 

Prepare Hard Disk 

Find Exact Strings 

Find string Pattern- 

Format Disk 

Set Disk File Attributes 

Find Strings matching Regular Expression 
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HSET 
LC2UC 
LIST 
LOGON 
LOGOFF 
MKDIR 
MORE | 
ORDER 


PASSWORD 


PASTE 
PATH 

PR 
PROCESS 
PROMPT 
RECDIR 
RECFILE 
RENAME 
RESTORE 
RMDIR 
SECURITY 
SORT 
SPLIT 
STRINGS 
SUM 

SYS 

TIME 
TREE 
TYPE 
UC2LC 
VER 

VOL 

WC 
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Utilities and Built-in Commands 


Set Shared Code in .286 File 
Lower Case to Upper Case 
List Built-in Commands 
Login as a different User 
End Logon Session 

Create a Disk Directory 
Display File One Screen at a time 
Set Command Type Search Order 
Change Login Password 
Merge Files Line by Line 
Set Command Search Path 
Format STDIN to STDOUT 
Display Current Tasks 
Change shell Prompt 
Repair Disk Directory 
Repair Disk File 

Rename or Move Disk Files 
Restore BACKUP Files 
Remove Disk Directory 

Set Default Security Word 
Sort STDIN to STDOUT 
Split a File 

Display Strings in File 
Checksum a File 

Build Boot Disk 
Display/Set Time 

Display Directory Paths 
Display File 

Upper Case to Lower Case 
Display OS VersionString 
Display Volume Label 
Count Words/Lines in File 


AT En ne ere 
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Development Environment 


Native Development 


286 68K 
C Compiler Metaware Alcyon 
Linker LINK86 LINK68 
Librarian LIB86 AR68 
Assembler RASM86 AS68 
Standalone Debugger ATLD SAS 


Process Debugger SID SID 
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